package com.pai4j.ugc.repository.dao;

import com.pai4j.ugc.repository.entity.CommunityContributionHistoryEntity;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
import org.springframework.stereotype.Repository;

import java.util.List;

/**
 * 社区共建历史数据访问接口
 *
 * @author: CYM-pai
 * @date: 2025/07/30 12:00
 **/
@Repository
public interface ICommunityContributionHistoryDAO extends JpaSpecificationExecutor<CommunityContributionHistoryEntity>, 
        JpaRepository<CommunityContributionHistoryEntity, Long> {

    /**
     * 根据共建ID查询历史记录列表
     *
     * @param contributionId 共建ID
     * @return 历史记录列表
     */
    List<CommunityContributionHistoryEntity> findByContributionIdOrderByCreateDateDesc(Long contributionId);

    /**
     * 根据共建ID分页查询历史记录列表
     *
     * @param contributionId 共建ID
     * @param pageable       分页信息
     * @return 分页的历史记录列表
     */
    Page<CommunityContributionHistoryEntity> findByContributionId(Long contributionId, Pageable pageable);

    /**
     * 根据操作人查询历史记录列表
     *
     * @param operator 操作人
     * @param pageable 分页信息
     * @return 分页的历史记录列表
     */
    Page<CommunityContributionHistoryEntity> findByOperator(String operator, Pageable pageable);

    /**
     * 根据操作类型查询历史记录列表
     *
     * @param action   操作类型
     * @param pageable 分页信息
     * @return 分页的历史记录列表
     */
    Page<CommunityContributionHistoryEntity> findByAction(Integer action, Pageable pageable);

    /**
     * 根据共建ID和操作类型查询历史记录列表
     *
     * @param contributionId 共建ID
     * @param action         操作类型
     * @return 历史记录列表
     */
    List<CommunityContributionHistoryEntity> findByContributionIdAndAction(Long contributionId, Integer action);

    /**
     * 根据共建ID删除所有历史记录
     *
     * @param contributionId 共建ID
     */
    void deleteByContributionId(Long contributionId);
}
